home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / prog / atari / c / berm122 / update.doc < prev    next >
Text File  |  1993-08-16  |  12KB  |  384 lines
  1.     Bermuda 1.22
  2.     ============
  3.  
  4. Modifications by Vincent Pomey (2:320/100.2) and Franck Arnaud (2:320/100)
  5. Cruncher by Vincent Pomey
  6.  
  7. See the LICENSE file for details about source code distribution policy
  8. and READ.ME about binary code distribution policy.
  9.  
  10.  
  11. Built-in archiver support
  12. =========================
  13.  
  14. Import now detects the type of arcmail, and launches the correct
  15. archiver. The following keywords have been added to tb.cfg:
  16.  
  17. arcunpack <path> <command-line>
  18. zipunpack <path> <command-line>
  19. arjunpack <path> <command-line>
  20. zoounpack <path> <command-line>
  21. lzhunpack <path> <command-line>
  22.  
  23. In the command line, %n is replaced by the name of the archive, and
  24. %d by the path where the packets will be extracted. %% is replaced by a 
  25. single %.
  26.  
  27. For example:
  28.  
  29. arcpack e:\bin\arc.ttp x %n %d*.*
  30.  
  31. Pack also supports various archivers; the arcmail command in the
  32. route file has been "replaced" by the new commands:
  33.  
  34. arcmail <nodes>
  35. zipmail <nodes>
  36. zoomail <nodes>
  37. arjmail <nodes>
  38. lzhmail <nodes>
  39.  
  40. This of course means that <nodes> will receive the arcmail type
  41. you choose, and the correct archivers will be called according to the
  42. new keywords in tb.cfg:
  43.  
  44. arcpack <path> <command-line>
  45. zippack <path> <command-line>
  46. arjpack <path> <command-line>
  47. zoopack <path> <command-line>
  48. lzhpack <path> <command-line>
  49.  
  50. In the <command-line>, %n will be replaced by the full name of the
  51. mail archive while %p will be replaced by the full name of the packet,
  52. %d by the directory where the packet reside and %k by the name of the
  53. packet without path.
  54.  
  55. For example:
  56.  
  57. arcpack e:\bin\arc.ttp a %n %p
  58.  
  59. If you use Arc/ST 6.02, STZip 2.1, Quester LHarc 2.01, Zoo 2.1, UnARJ
  60. 1.00 by J Webb, we suggest the following configuration:
  61.  
  62. arcunpack e:\bin\arc.ttp xo %n %d*.*
  63. zipunpack e:\bin\stzip.ttp -xo %d %n
  64. lzhunpack e:\bin\lharc.ttp x -m %n %d
  65. zoounpack e:\bin\zoo.ttp -extract %n %d*
  66.  
  67. arcpack e:\bin\arc.ttp m %n %p
  68. zippack e:\bin\stzip.ttp -am %n %p
  69. lzhpack e:\bin\lharc.ttp m /m %n %p
  70.  
  71. If you don't use this feature, the old -a command line command still
  72. works as usual.
  73.  
  74.  
  75. Pass-thru areas
  76. ===============
  77.  
  78. If you are a large node, you may redistribute many echos you or your
  79. users don't read, and it takes some time to process and/or to scan.
  80. Now, if the <path> of the area is "passthru" in areas.bbs, Import
  81. will not write the messages to the message base, and Scan will not
  82. try to scan this area.
  83.  
  84. For example:
  85.  
  86. e:\msgs\0100    ATARIST     2:1000/1
  87. passthru        AMIGA       2:1000/1 2:1234/5 2:34/56
  88. passthru        KITCHEN     2:78/78 2:1902/2890
  89.  
  90.  
  91. no-hold keyword in tb.rte
  92. =========================
  93.  
  94. The no-hold keyword has been added to tb.rte, it complements the "hold"
  95. keyword. Mail for a node will be put on hold if
  96.  
  97.    1. this node matches "hold" and
  98.    2. doesn't match "no-hold"
  99.  
  100. It allows one to simplify one's config.
  101.  
  102. For example:
  103.  
  104. Instead of writing
  105.  
  106.     if normal
  107.     hold 1:1/1 2:2/2 2:3/3
  108.     if boss1
  109.     poll 1:1/1
  110.     hold 2:2/2 3:3/3
  111.     if boss2
  112.     poll 2:2/2
  113.     hold 1:1/1 3:3/3
  114.     id boss3
  115.     poll 3:3/3
  116.     hold 1:1/1 2:2/2
  117.  
  118. You can just just write
  119.  
  120.     hold 1:1/1 2:2/2 3:3/3
  121.     if boss1
  122.     poll 1:1/1
  123.     no-hold 1:1/1
  124.     if boss2
  125.     poll 2:2/2
  126.     no-hold 2:2/2
  127.     if boss3
  128.     poll 3:3/3
  129.     no-hold 3:3/3
  130.  
  131.  
  132. Forwarded mail is deleted
  133. =========================
  134.  
  135. If your system receives netmail from other nodes, and if it is routed to
  136. somewhere else (if you are a hub for example, or messages from/to
  137. your points), Imports marks the messages as Kill/Sent so that Pack
  138. can delete them with the Killed flag once they have been sent. This
  139. option may be disabled with the keyword "nokillrouted" in tb.cfg.
  140.  
  141.  
  142. Adding all your akas in seen-by lines
  143. =====================================
  144.  
  145. An undocumented feature is now usable :-). If you insert -d in the
  146. Import or Scan command line, the the seen-by will include all your
  147. addresses, while the addresses in other zones are automatically stripped,
  148. so this results in all your akas in the zone of the echo (defined as
  149. you know by the first node in areas.bbs) present in the seen-by.
  150.  
  151.  
  152. New display of imported messages
  153. ================================
  154.  
  155. Import now displays the number of messages that have been echoed in
  156. each area, this allows you to see if routing works well, and to
  157. detect problems more easily.
  158.  
  159.  
  160. Support of incoming 4D packets
  161. ==============================
  162.  
  163. Import now recognises the extended Type 2 Packet headers, as defined
  164. in fsc-0039, fsc-0045 (type 2.2), fsc-0048 (type 2+). Bermuda still
  165. produces FSC-0001 packets, which works quite well anyway :-).
  166.  
  167.  
  168. Redirection of Netmail according to the key # statement
  169. =======================================================
  170.  
  171. If you have a key # statement in your tb.cfg, for example:
  172.  
  173. key #100:242/1 100:all
  174.  
  175. and if you write a netmail to 100:345/25, the netmail will be sent as
  176. coming from 100:242/1 regardless of the originating node number written
  177. in the header by the message editor. This is very useful with LED for
  178. example. This applies only to messages entered locally.
  179.  
  180.  
  181. Direct flag for netmails
  182. ========================
  183.  
  184. Direct mail allows you to send a netmail directly to the node without
  185. routing, but in a normal mail packet rather than in a crashmail packet.
  186. You can send semi-urgent mail directly to the node during low phone cost
  187. periods, by setting the Direct flag of a message. (Note that these messages
  188. are affected by an eventual HOLD statement in TB.RTE)
  189. Direct flag is bit 10 of the message flags. Since most messages editors
  190. (namely Led) don't allow to change it, setting both Crash and Hold
  191. flags is equivalent to setting the Direct flag.
  192.  
  193.  
  194. Never mix rerouting and password statements in key lines
  195. ========================================================
  196.  
  197. A common error is to mix rerouting statements (key #) and passwords (key !) 
  198. for example a point, which also have a fidonet primary address, may think 
  199. this is right:
  200.  
  201. key #100:234/567.8 !password 100:234/567
  202.  
  203. This is not correct! This means that you are behaving as 100:234/567.8 with 
  204. your Boss only, but not if you write netmails to other nodes in the zone 100,
  205. you will be using your primary (fidonet) address.
  206.  
  207. The correct setup is:
  208.  
  209. key #100:234/567.8 100:all
  210. key !password 100:234/567
  211.  
  212.  
  213. Application Bermuda
  214. ===================
  215.  
  216. Configuration lines specific to Bermuda may start by 'application
  217. bermuda' in tb.cfg. This may be used for key statement that apply
  218. only to Bermuda and not to The-Box or other programs using TB.CFG.
  219.  
  220. It is especially useful with EMSI versions of The-Box. If you want EMSI 
  221. to work as expected in The-Box you must write key # statements behind 
  222. application:
  223.  
  224. application bermuda key #90:4/5 90:all
  225.  
  226. A second required thing to make The-Box EMSI works is to write all akas 
  227. of one boss node behind one password line, because The-Box uses this 
  228. information to know to which akas it must send mail. Unlike other mailers, 
  229. it does not try to send mail to all akas of the other side, hence making 
  230. sessions shorters with people having many akas.
  231.  
  232. ; sends mail in the same emsi session to both logical boss nodes
  233. key !mypass 2:345/678 90:100/110 
  234.  
  235.  
  236. Messages To Sysop
  237. =================
  238.  
  239. Messages to 'sysop' in echomail areas are not counted as "sysop messages"
  240. in the report. Usually echomail messages to "sysop" are written by buggy 
  241. software or people on other nodes.
  242.  
  243.  
  244. Scanned messages are 'Sent'
  245. ===========================
  246.  
  247. Scan sets the Sent flag in processed echomail messages. It allows you to 
  248. see if a message has already been scannned by looking at the flags in 
  249. your message editor. Besides it is more compatible with Scanners not using 
  250. the mailer[7] field as usual. Scan still upgrades the mailer[7] field.
  251.  
  252.  
  253. Crunch utility
  254. ==============
  255.  
  256. This is the new fourth face of the Bermuda triangle :-) the program is 
  257. used to delete old messages, so it "crunches" your message base and prevent 
  258. it from becoming very huge. There are several ways to choose how many and 
  259. which messages will be deleted per area. You may indicate the default one 
  260. in the command line of crunch.
  261.  
  262. For each area, you specify the way to delete messages by putting an
  263. option line before the area line in areas.bbs.
  264.  
  265. ** -days nnn [min mmm] [max ppp]
  266.  (with the equivalent form in the command line : crunch -dnnn [-mmmm] [-xppp])
  267.  
  268. This will keep only the last nnn days of messages.
  269.  
  270. If the min field is present, the number of messages will never go under
  271. mmm, even if the kept messages are very old.
  272. If the max field is present, the number of messages will never go over
  273. ppp, even if some of the deleted messages were receiving during the
  274. last nnn days.
  275.  
  276. ** -msgs nnn
  277.  
  278. This will keep the last nnn messages. 
  279.  
  280. (nnn, mmm and ppp are numbers with any number of digits.)
  281.  
  282. Ex:
  283. -days 2
  284. e:\msgs\0055 TALK
  285. -msgs 300
  286. e:\msgs\0056 THINK
  287. -days 30 min 5 max 200
  288. e:\msgs\0057 SLEEP
  289.  
  290. If you call crunch without setting the default in the command line, the
  291. default will be keep 30 days.
  292.  
  293. If a message has the NOKILL flag set (this is new and is the bit 11 of
  294. the message flags), that message won't be deleted because of its age.
  295.  
  296. Crunch updates the reply links and the files LED.NEW and LASTREAD.BBS
  297. if found.
  298.  
  299.  
  300. Pack and INTL lines
  301. ===================
  302.  
  303. Pack will always add INTL lines in netmails if you add the -i switch
  304. on its command line. Otherwise it will only add it for inter-zone
  305. netmails. This should help some importers to find the zone number.
  306.  
  307.  
  308. Binkley compatible outbound
  309. ===========================
  310.  
  311. Pack will handle a Binkley 3.0 outbound if you specify 'binkley' in
  312. the configuration file. Now it doesn't renames the file, all is done
  313. internally. However, you should have outbound.zone directory created
  314. for all your possible zone. If Pack wants to create a packet for zone
  315. 8 and outbound.008 doesn't exist, it will crash. Note that this problem
  316. doesn't exist when you're using The-Box !
  317.  
  318.  
  319. Various little bug fixes
  320. ========================
  321.  
  322. Don't forget there is a bad messages area to put bad messages instead 
  323. of putting them in the Netmail area. Just add a BADMSGS area in your 
  324. areas.bbs file.
  325.  
  326. In Scan, if you have various key # statements and you send an echo to
  327. several nodes for whom your address is not the same as the one of the key
  328. #, the packets were not correctly addressed. This has been corrected.
  329.  
  330. An area like MAILBOX.GER is no longer recognised as the mail area in Scan.
  331.  
  332. In Pack, the "via" line now displays 19 Jan 92 instead of 01/19, as
  333. it is done by most programs.
  334.  
  335. For point systems, the netmails are imported with the 4D address
  336. written in the message header, which looks nicer.
  337.  
  338. In scan, an extra line is added before the tearline at the end of the
  339. message, so that the message looks nicer :-).
  340.  
  341. Small bug fixes now allow sophisticated key # configurations to work
  342. correctly with Scan and Import (e.g. if you have a different aka for two 
  343. nodes who receive the same echo area).
  344.  
  345. Changing the origin of a netmail according to the key statement,
  346. renaming bad arcmail bundles, importing echomail in a point from a
  347. TosScan boss works all correctly now.
  348.  
  349. When a packet with zone 0 arrives, it is considered as comming from
  350. your main zone (the one in the first address statement in tb.cfg),
  351. rather than from the zone of the last packet processed.
  352.  
  353. The strange routing bug is fixed (if a netmail is to be routed to
  354. 2:320/7 it was sometimes routed to 2:320/7x, x behing a number changing
  355. from time to time).
  356.  
  357. Maximum number of areas in areas.bbs is now 500, and the programs tells
  358. when overflow.
  359.  
  360. Added a -n switch to suppress generating INTL lines in inter-zone
  361. echomail messages. Also note that the switch to add kludges in SEEN-BY
  362. and AREA lines is -k.
  363.  
  364. Added a -i switch to always add INTL lines in netmail messages, even
  365. if there're not interzone (used by some old technology tossers).
  366.  
  367. The problem with Pack not handling xxxmail (arcmail, lzhmail...) as
  368. expected when used with wildcards in TB.RTE is suppressed.
  369.  
  370. Fixed some problems with zone numbers in SEEN-BY/PATH lines.
  371.  
  372.  
  373. Will Bermuda produce Type 2+ packets in the future?
  374. ===================================================
  375.  
  376.                                              "No way." - Jac Kersing
  377.  
  378. Bermuda doesn't produce anything else than FTS-0001 release 15 type 
  379. two packets. This is a feature. There are at least three proposals of 
  380. "enhancements" to type 2 packets, none of them is really satisfactory, 
  381. and many implementations don't even follow the proposals. The situation 
  382. is so messy and the "enhancement" so ridiculous, that we'll stick to 
  383. standard packets that works pretty well, anyway. 
  384.